Getting Started

Install the server, start it, and connect a client.

Desktop app available for macOS. Download — no workarounds needed. Windows and Linux coming soon.

Tools require Node.js or Bun. Installed automatically if needed.

Install the server

Jean2 is a single binary. No runtime, no containers, no dependencies.

curl -fsSL https://jean2.ai/install.sh | bash

irm https://jean2.ai/install.ps1 | iex

This downloads the binary to ~/.jean2/bin and adds it to your PATH.

jean2 init

This walks you through the first-time setup — default agent configs, recommended tools, and creates ~/.jean2/ as your config directory.

jean2 start

The server starts as a background daemon on http://localhost:8742. It prints an API token — copy it, you'll need it to connect your client.

If you missed the API token during startup, retrieve it anytime:

jean2 auth show

No install needed. Run directly from npm:

npx @jean2/client

Open the URL it prints and paste your API token.

Open the .dmg, drag Jean2 to your Applications folder, and launch it. Paste your API token when prompted.

Download the latest release from GitHub Releases.

The app is unsigned — Windows Defender SmartScreen will block it. Click More info then Run anyway to proceed.

Paste your API token when prompted.

There is no native desktop client yet. Use the browser client:

npx @jean2/client

jean2 update

This pulls the latest version, replaces the binary, and restarts the server. Any database migrations run on startup automatically.

Download the latest .dmg and replace the old app. Settings and tokens are preserved.

Check for available updates:

jean2 tools outdated

Update all installed tools:

jean2 tools update